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RSTS/E DOCUMENTATION DIRECTORY 

RSTS/E software consists of distribution media and documentation. 
The documentation describes the components and operation of the 
RSTS/E software. This directory describes the RSTS/E documentation. 

1.0 ORGANIZATION OF THE DOCUMENT SET 

The RSTS/E document set is logically divided into 5 categories, as 
follows: 

system reference 

system procedures 

system management and maintenance 

languages 

optional software 

Table 1 lists the manuals by category and indicates the intended 
audience of each manual. 





Table 1 
RSTS/E Documentation 


Set 




Category 


Document 
Title 




Audience 




System 
Manager 


System 
Programmer 


General 
User 


System 
Reference 


RSTS/E Document 
Directory 

RSTS/E Programming 
Manual 


X 


X 
X 


X 




RSTS/E System 

Generation 

Manual 


X 


X 




System 
Procedures 


RSTS/E System 
Manager ' s Guide 


X 


X 






RSTS-11 System 
User's Guide 


X 


X 


X 




RSTS/E RUNOFF 
User's Guide 






X 




DOS /BATCH Text 
Editor (EDIT) 
Programmer ' s 
Manual 




X 


X 




PDP-11 ROLLIN 
Utility 
Programmer ' s 
Manual 


X 


X 




System 
Management 
and 
Maintenance 


System 

Generation 

Manual 


X 


X 






RSTS/E System 

Installation 

Notes 


X 


X 






RSTS/E System 

Reliability 

Test 


X 


X 






RSTS/E System 
Manager ' s Guide 


X 


X 





Table 1 (Cont.) 
RSTS/E Documentation Set 



Category 


Document 
Title 


Audience 


System 
Manager 


System 
Programmer 


General 
User 


Languages 


BASIC-PLUS 
Language 

JXi.ci.i.i.iA€i -l. 




X 


X 




PDP-11 COBOL 
Language 
Reference 
Manual 




X 


X 




PDP-11 COBOL 
User's Guide 




X 


X 




PDP-11 COBOL 
Language 
Reference 
Card 




X 


X 


Optional 
Software 


PDP-11 SORT 
User's Guide 

RSTS/E 
Commercial 
User ' s Guide 

RSTS/E 2780 
User's Guide 

RSTS-11 Sort 
User's Guide 




X 

X 
X 


X 



2.0 DOCUMENT DESCRIPTION 

The following paragraphs summarize the information contained in each 
manual in the document set. The first four documents are listed in 
the recommended reading order for the system manager. The remaining 
documents can be read in any order that is suitable to one's interests, 

RSTS/E System Generation Manual 

RSTS/E System Installation Notes 

RSTS/E System Reliability Test 

RSTS/E System Manager's Guide 

RSTS-11 System User's Guide 

BASIC-PLUS Language Manual 

RSTS/E Programming Manual 

RSTS/E RUNOFF User's Guide 

DOS/BATCH Edit 

PDP-11 ROLLIN 

PDP-11 COBOL Language Reference Manual 

PDP-11 COBOL User's Guide 

PDP-11 COBOL Reference Card 

PDP-11 SORT User's Guide 

RSTS/E Commercial User's Guide 

RSTS/E 2780 User's Guide 

RSTS-11 Sort User's Guide 



2.1 RSTS/E System Generation Manual (DEC-11-ORGNA-A-D) 

This manual describes the complete procedures to generate the V06A-02 
RSTS/E system image, initialize system structures, and build the system 
library. Also included are procedures to build optional RSTS/2780 
and PDP-11 COBOL software. Because RSTS/E supports a variety of hard- 
ware and offers many optional software features, the manual also contains 
reference information useful for planning and maintaining the system. 
Especially important are the system initialization options. They are 
used both to optimize system structures and to maintain and restructure 
the system. 



2.2 RSTS/E System Installation Notes (DEC-11-0RINB-C-D) 

This document contains system code and library code patches and hard- 
ware and software installation guidelines related to the version of 
RSTS/E. The information is required for generating RSTS/E. 

2.3 RSTS/E System Reliability Test (DEC-11-0RSRB-B-D) 

This document describes the procedures to build system test files and 
run device exerciser programs. The document is designed to be used 
with the RSTS/E System Generation Manual. 

The system test procedures are followed after a new RSTS/E system is 
generated or can be used later to isolate hardware or system software 
malfunctions. 

2.4 RSTS/E System Manager's Guide (DEC-11-0RSMD-A-D) 

This guide is directed to the individual who administrates and controls 
the local installation. It contains information on utilization of 
hardware and software resources. The material is more detailed than 
that presented in the RSTS/11 System User's Guide and is directed more 
at the privileged user than at the non-privileged user. Also included 
are the operational procedures necessary to daily functioning of the 
system. Included are guidelines for controlling system start up, 
shutdown, and job execution; procedures for creating accounts and pro- 
ducing account statistics; procedures for queue management and spooling, 
for system error detection and correction; and for system utility opera- 
tions such as disk management, run time system control, system statis- 
tics, terminal characteristics, and optimizing disk directories. 

2.5 RSTS-11 System User's Guide (DEC-11-0RSUA-D-D) 

This guide is directed at the time sharing user. Information on 

system commands and system programs is provided. Most functions 

described are non-privileged and the material is general in nature. 
Also included are device operating procedures. 



2.6 BASIC-PLUS Language Manual (DEC-11-ORBPB-A-D) 

This manual introduces the beginning user to the more elementary 
parts of the BASIC-PLUS language and explains for the experienced 
user the more advanced features of BASIC-PLUS as implemented in 
Version V6A of RSTS/E. Procedures are explained to help a user debug 
a program and to write more advanced code. The more commonly used 
system functions are described along with the three forms of input/ 
output available: formatted ASCII, virtual core, and Record I/O. 
The manual is a complement of the RSTS/E Programming Manual. 

2.7 RSTS/E Programming Manual (DEC-11-0RPMA-A-D) 

This manual presents device dependent features and more complex system 
function descriptions for the advanced programmer who uses RSTS/E 
V06A. Both file structured and non-file structured operations are 
described for disk, magnetic tape, paper tape, terminals, and line 
printers. The system function calls to monitor are defined and 
programming conventions explained. 

2.8 RSTS/E RUNOFF User's Guide (DEC-11-URUNA-B-D) 

This guide presents operating and preparation information for the 
RSTS/E V06A text formatting system program RUNOFF. The manual 
describes RUNOFF commands and their effect in the output text and shows 
how to produce a formatted output file. 

2.9 DOS/BATCH Text Editor (EDIT) Programmer's Manual (DEC-11-UEDAA-A-D] 

This manual describes file creation, editing and manipulating pro- 
cedures for the EDIT-11 program which is compatible with the RSTS/E 
EDIT system program. The commands and operating procedures are defined 
in this manual and summarized in the RSTS-11 System User's Guide for 
EDIT. 

2.10 PDP-11 ROLLIN Utility Programmer's Manual (DEC-11-OROAA-B-D) 

This manual describes the commands and operating procedures for 
making image mode copies of disks or for transferring images to 
and from tape using the stand alone program ROLLIN. 



2.11 PDP-11 COBOL Language Reference Manual 1 (DEC-11-LC0BA-B-D) 

This manual describes the COBOL Language elements as implemented on 
the PDP-11. It is based on the document American National Standard 
COBOL, X3.23 - 1974, both for organization and content. Descriptions 
of PDP-11 extensions to the standard language are shaded. 

2.12 PDP-11 COBOL User's Guide 1 (DEC- 11-LCUGA-A-D) 

This guide is a companion document to the PDP-11 COBOL Language 
Reference Manual. It contains additional information on the compiler, 
the run time system utility programs and a complete list of COBOL 
error messages. 

2.13 PDP-11 COBOL Reference Card 1 (DEC-11-LCRCA-A-D) 

The card is a handy pocket reference containing the COBOL statement 
formats, a list of the compiler-reserved words, constants, picture 
symbols, and an ASCII code chart. 

2.14 PDP-11 SORT Reference Manual 1 (DEC-11-USTMA-A-D) 

This manual describes the features and operation of the PDP-11 SORT 
program distributed with the COBOL compiler and object time system. 

2.15 RSTS/E Commercial User's Guide 1 (DEC-11-0RCUA-A-D) 

This guide describes generation and operation of the RSTS/E Indexed 
Access Method (IAM) and the commercial QUE and LPSPL programs. Also 
described is the decimal 4-word arithmetic package. 

2.16 RSTS-11 Sort User's Guide (DEC-ORSGA-A-D) 

This guide describes the generation and operation of the RSTS-11 Sort 
programs distributed with the RSTS/E Commercial User's package. The 
Sort programs are coded in BASIC-PLUS and stored in the system library 
as compiled (BAC) files. Also included in the guide are file formats, 
error messages, program interfaces, key extraction technique, and the 
use of the key file dump utility. 



Available under separate license. 



2.17 RSTS/E 2780 User's Guide (DEC-11-ORJEA-A-D) 

This guide describes the operation of the RJ2780 program for users 
of RSTS/E systems with the RSTS/2780 software package. Included are 
a summary of the build procedures, a list of hardware and software 
options, and the steps required to send data to and receive data from 
a remote computer system. Features related to the 2780 environment 
are described in the document 2780 Remote Computer Systems Installation 
Notes. 



HOW TO OBTAIN SOFTWARE INFORMATION 

SOFTWARE NEWSLETTERS, MAILING LIST 

The Software Communications Group, located at corporate headquarters in 
Maynard, publishes software newsletters for the various DIGITAL products, 
Newsletters are published monthly, and keep the user informed about cus- 
tomer software problems and solutions, new software products, documenta- 
tion corrections, as well as programming notes and techniques. 

There are two similar levels of service: 

The Software Dispatch 
The Digital Software News 

The Software Dispatch is part of the Software Maintenance Service. This 
service applies to the following software products: 

PDP-9/15 
RSX-11D 
DOS /BATCH 
RSTS/E 
DECsystem-10 

A Digital Software News for the PDP-11 and a Digital Software News for 
the PDP-8/12 are available to any customer who has purchased PDP-11 or 
PDP-8/12 software. 

A collection of existing problems and solutions for a given software 
system is published periodically. A customer receives this publication 
with his initial software kit with the delivery of his system. This 
collection would be either a Software Dispatch Review or Software Per- 
formance Summary depending on the system ordered. 

A mailing list of users who receive software newsletters is also main- 
tained by Software Communications. Users must sign-up for the news- 
letter they desire. This can be done by either completing the form sup- 
plied with the Review or Summary or by writing to: 

Software Communications 

P.O. Box F 

Maynard, Massachusetts 01754 

SOFTWARE PROBLEMS 

Questions or problems relating to DIGITAL'S software should be reported 
as follows: 

North and South American Submitters : 



Upon completion of Software Performance Report (SPR) form remove last 
copy and send remainder to: 

Software Communications 

P.O. Box F 

Maynard, Massachusetts 01754 

The acknowledgement copy will be returned along with a blank SPR form 
upon receipt. The acknowledgement will contain a DIGITAL assigned SPR 
number. The SPR number or the preprinted number should be referenced in 
any future correspondence. Additional SPR forms may be obtained from 
the above address. 

All International Submitters : 

Upon completion of the SPR form, reserve the last copy and send the re- 
mainder to the SPR Center in the nearest DIGITAL off ioe. SPR forms are 
also available from our SPR Centers. 

PROGRAMS AND MANUALS 

Software and manuals should be ordered by title and order number. In the 
United States, send orders to the nearest distribution center. 



Digital Equipment Corporation 
Software Distribution Center 
146 Main Street 
Maynard, Massachusetts 01754 



Digital Equipment Corporation 
Software Distribution Center 
1400 Terra Bella 
Mountain View, California 94043 



Outside of the United States, orders should be directed to the nearest 
Digital Field Sales Office or representative. 

USERS SOCIETY 

DECUS, Digital Equipment Computers Users Society, maintains a user ex- 
change center for user-written programs and technical application infor- 
mation. The Library contains approximately 1,900 programs for all 
DIGITAL computer lines. Executive routines, editors, debuggers, special 
functions, games, maintenance and various other classes of programs are 
available. 

DECUS Program Library Catalogs are routinely updated and contain lists 
and abstracts of all programs according to computer line: 

PDP-8, FOCAL-8, BASIC-8, PDP-12 
PDP-7/9, 9, 15 
PDP-11, RSTS-11 
PDP-6/10, 10 

Forms and information on acquiring and submitting programs to the DECUS 
Library may be obtained from the DECUS office. 

In addition to the catalogs, DECUS also publishes the following: 

DECUSCOPE -The Society's technical newsletter, published bi-monthly, 

aimed at facilitating the interchange of technical in- 
formation among users of DIGITAL computers and at dis- 
seminating news items concerning the Society. Circula- 
tion reached 19,000 in May, 1974. 



-Contains technical papers presented at DECUS Symposia 
held twice a year in the United States, once a year 
in Europe, Australia, and Canada. 

-A report of the DECsystem-10 sessions held at the two 
United States DECUS Symposia. 

-A monthly mailed communique among DECsystem-10 users. 

-Mailing of Local User Group (LUG) and Special Interest 
Group (SIG) communique, aimed at providing closer 
communication among users of a specific product or 
application. 

Further information on the DECUS Library, publications, and other DECUS 
activities is available from the DECUS offices listed below: 



PROCEEDINGS OF 
THE DIGITAL 
EQUIPMENT USERS 
SOCIETY 

MINUTES OF THE 

DECsystem-10 

SESSIONS 

COPY-N-Mail 

LUG/SIG 



DECUS 

Digital Equipment Corporation 

146 Main Street 

Maynard, Massachusetts 01754 



DECUS EUROPE 

Digital Equipment Corp. 

(Europe) 

P.O. Box 340 

1211 Geneva 26 

Switzerland 



International 



RSTS/E Documentation 

Directory 

DEC-11-ORDAA-A-D 



READER'S COMMENTS 



NOTE: This form is for document comments only. Problems 
with software should be reported on a Software 
Problem Report (SPR) form (see the HOW TO OBTAIN 
SOFTWARE INFORMATION page) . 



Did you find errors in this manual? If so, specify by page. 



Did you find this manual understandable, usable, and well-organized? 
Please make suggestions for improvement. 



09 

C 

o 



3 Is there sufficient documentation on associated system programs 

° required for use of the software described in this manual? If not, 

g what material is missing and where should it be placed? 



Please indicate the type of user/reader that you most nearly represent. 

f~~) Assembly language programmer 

Q Higher-level language programmer 

| | Occasional programmer (experienced) 

| | User with little programming experience 

I | Student programmer 

f"~| Non-programmer interested in computer concepts and capabilities 



Name - . Date , 

Organization 

Street — 



City State Zip Code. 

or 
Country 



-I .. _1__— _ —-U^—l, U^tv.n 



Fold Here 



-- Do Not Tear - Fold Here and Staple 
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